﻿
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- saved from url=(0014)about:internet -->
<html xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:mssdk="winsdk" xmlns:script="urn:script" xmlns:build="urn:build" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="Description" content="In user mode, the .kill command ends a process that is being debugged."/>
<meta name="MSHAttr" content="PreferredSiteName:MSDN"/>
<meta name="MSHAttr" content="PreferredLib:/library/windows/hardware"/>
<title>.kill (Kill Process)</title>

<meta name="MS-HAID" content="r20_metacmds_E_5c2717e9-eef2-4d91-9a54-33653ba7f904.xml"/>


<link rel="STYLESHEET" type="text/css" HREF="../common/backsdk4.css"/>





<style>
html,div { margin: 0; padding: 0;}

body {
	padding: 0px;
	margin: 0px;
	overflow: auto;
	height: 100%;
}

#winchm_template_button{
	float: right;
	width: 93px;
	top: 7px;
	position: relative;
	text-align: right;
	right: 5px;
	height: auto;
}

#winchm_template_top{
	padding: 0px;
	margin: 0px;
	border-bottom: 1px solid #9B9B9B;
	background-color: #B1CEFE;
}

#winchm_template_navigation{
	margin: 0px;
	padding-top: 7px;
	padding-left: 7px;
	padding-bottom: 3px;
	padding-right: 0px;
	font-size: 8.5pt;
	font-family: Arial, Helvetica, sans-serif;
	font-weight: normal;
	color: #585858;
}

#winchm_template_title{
	margin: 0px;
	padding-top: 4px;
	padding-left: 7px;
	padding-bottom: 7px;
	padding-right: 0px;
	font-size: 18px; 
	font-family: Verdana, Geneva, sans-serif;
	color: #363636;
}

#winchm_template_content{
	margin-top: 20px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	width: auto  !important;
	width: 100%;
}

#winchm_template_footer{
	border-width: 1px;
	border-color: #B1CEFE;
	border-top-style: solid;
	margin-top: 15px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	padding-top: 7px;
	padding-left: 0px;
	padding-bottom: 0px;
	padding-right: 0px;
	font-family: arial, helvetica, sans-serif;
	font-size: 8.5pt;
	color: #696969;
	width: auto;
	text-align: left;
}


#winchm_template_container{
	margin: 0px;
	padding: 0px;
	position: static;
	padding-bottom: 3px;
	overflow: auto;
	background-color: #FFFFFF;
}


@media print
{
#winchm_template_container{
	position: static;	
	margin: 0px;
	padding: 5px;
	
	width: auto;
	height: auto;
	overflow: auto;
}
#winchm_template_button{
visibility:hidden;
}
}

#winchm_template_navigation A:link	{text-decoration: none; color:#004080}
#winchm_template_navigation A:visited  {text-decoration: none; color: #004080}
#winchm_template_navigation A:active {text-decoration: none; color: #004080 }
#winchm_template_navigation A:hover {text-decoration: none;color: #0080FF}

A:link	{text-decoration: underline; color:#0033CC}
A:visited  {text-decoration: underline; color: #0033CC}
A:active {text-decoration: underline; color: #0033CC }
A:hover {text-decoration: underline;color: #FF0000;}
</style>
<script type="text/javascript">
function isMobile(){
Agent = window.navigator.userAgent;
if (Agent.indexOf("iPhone")>=1 || Agent.indexOf("iPad")>=1 || Agent.indexOf("iPod")>=1 || Agent.indexOf("Android")>=1){
return true;
}else{
return false;	
}

}
function d_onresize(){
if (window.navigator.userAgent.indexOf("MSIE")>=1){
document.getElementById('winchm_template_container').style.pixelWidth = document.body.offsetWidth - 3;
document.getElementById('winchm_template_container').style.pixelHeight = document.body.offsetHeight - document.getElementById('winchm_template_top').offsetHeight - 4;
}
document.getElementById('winchm_template_container').style.top = document.getElementById('winchm_template_top').offsetHeight + 'px';
}

function d_onbeforeprint(){
document.getElementById('winchm_template_container').style.width = 'auto';
document.getElementById('winchm_template_container').style.height = 'auto';
}

function d_onafterprint(){
d_onresize();
}

if(!isMobile()){

window.onload = d_onresize;
window.onresize = d_onresize;
window.onbeforeprint = d_onbeforeprint;
window.onafterprint = d_onafterprint;

document.write("<style>\n");
document.write("body {overflow: hidden;}\n");
document.write("#winchm_template_container {position: absolute;overflow: auto;top : 0px;right: 0px;bottom: 0px;left: 0px;}\n");
document.write("</style>\n");
}

</script>
</head>
<body><script language="JavaScript" type="text/JavaScript">
function syn(){
if(parent.nav.tree){
 if(parent.nav.tree.loaded){
  parent.nav.tree.selectNode(2130);
 }else{
  setTimeout("syn()",500);
}
  }else{
  setTimeout("syn()",500);
  }}
if(parent!=self){
  setTimeout("syn()",100);
}else{
  parent.location.href = "../../index.htm?page=debugger/_kill__kill_process_.htm";
}
originalOnload = window.onload;
if(originalOnload==null){
window.onload = function(){parent.contentLoaded = true;};
}else{
window.onload = function(){originalOnload();parent.contentLoaded = true;};
}
</script> 


<div id="winchm_template_top">
	<div id="winchm_template_button"><A href="_kframes__set_stack_length_.htm" title="Previous topic"><img id="winchm_template_prev" alt="Previous topic" src="../template2/btn_prev_n.gif" border="0"></a><A href="_lastevent__display_last_event_.htm" title="Next topic"><img id="winchm_template_next" alt="Next topic" src="../template2/btn_next_n.gif" border="0"></a></div>
	<div id="winchm_template_navigation">Help &gt; 
<A href="introduction6.htm">Debugging Tools for Windows (WinDbg, KD, CDB, NTSD)</A> &gt; <A href="debugger_reference.htm">Debugger Reference</A> &gt; <A href="debugger_commands.htm">Debugger Commands</A> &gt; <A href="meta_commands.htm">Meta-Commands</A> &gt; </div>
	<div id="winchm_template_title">.kill (Kill Process)</div>
</div>
<div id="winchm_template_container">
	<div id="winchm_template_content"><div id="mainSection"><p>
    In user mode, the <b>.kill</b> command ends a process that is being debugged.</p>
<p>
    In kernel mode, the <b>.kill</b> command ends a process on the target computer.</p>
<p>User-Mode Syntax</p>
<pre class="syntax"><b>.kill </b>[ <b>/h</b> | <b>/n</b> ]</pre>
<p>Kernel-Mode Syntax</p>
<pre class="syntax"><b>.kill </b><i>Process</i> </pre>
<h2><a id="ddk_meta_kill_process_dbg"></a><a id="DDK_META_KILL_PROCESS_DBG"></a>Parameters</h2>
<p></p>
<dl>
<dt><a id="________h______"></a><a id="________H______"></a>       <b>/h</b>      </dt>
<dd>
<p>
       (User mode only)  Any outstanding debug event will be continued and marked as handled.  This is the default.</p>
</dd>
<dt><a id="________n______"></a><a id="________N______"></a>       <b>/n</b>      </dt>
<dd>
<p>
       (User mode only)  Any outstanding debug event will be continued without being marked as handled.</p>
</dd>
<dt><a id="_______Process______"></a><a id="_______process______"></a><a id="_______PROCESS______"></a>       <i>Process</i>      </dt>
<dd>
<p>Specifies the address of the process to be terminated. If <i>Process</i> is omitted or zero, the default process for the current system state will be terminated.</p>
</dd>
</dl>
<h3><a id="Environment"></a><a id="environment"></a><a id="ENVIRONMENT"></a>Environment</h3>
<p>In kernel mode, this command is supported on Microsoft Windows Server 2003 and later versions of Windows.</p>
<table>
<tr>
<td>
<p><b>Modes</b></p>
</td>
<td>
<p>user mode, kernel mode</p>
</td>
</tr>
<tr>
<td>
<p><b>
          Targets</b></p>
</td>
<td>
<p>live debugging only</p>
</td>
</tr>
<tr>
<td>
<p><b>Platforms</b></p>
</td>
<td>
<p>all </p>
</td>
</tr>
</table>
<p> </p>
<h2>Remarks</h2>
<p>In user mode, this command ends a process that is being debugged. If the debugger is attached to a child process, you can use <b>.kill</b> to end the child process without ending the parent process. For more information, see Examples.</p>
<p>In kernel mode, this command schedules the selected process on the target computer for termination. The next time that the target can run (for example, by using a <a href="#Bookmark1997"><b>g (Go)</b></a> command), the specified process is ended.</p>
<p>You cannot use this command during local kernel debugging.</p>
<h2>Examples</h2>
<p><b>Using .childdbg</b></p>
<p>Suppose you attach a debugger to parent process (Parent.exe) before it creates a child process. You can enter the command <a href="#Bookmark2068"><b>.childdbg 1</b></a> to tell the debugger to attach to any child process that the parent creates.</p>
<pre class="syntax" xml:space="preserve"><code>1:001&gt; .childdbg 1
Processes created by the current process will be debugged</code></pre>
<p>Now let the parent process run, and break in after it has created the child process. Use the <a href="#Bookmark1960"><b>| (Process Status)</b></a> command to see the process numbers for the parent and child processes.</p>
<pre class="syntax" xml:space="preserve"><code>0:002&gt; |*
.  0	id: 7f8	attach	name: C:\Parent\x64\Debug\Parent.exe
   1	id: 2d4	child	name: notepad.exe</code></pre>
<p>In the preceding output, the number of the child process (notepad.exe) is 1. The dot (.) at the beginning of the first line tells us that the parent process is the current process. To make the child process the current process, enter <b>|1s</b>.</p>
<pre class="syntax" xml:space="preserve"><code>0:002&gt; |1s
...
1:001&gt; |*
#  0	id: 7f8	attach	name: C:\Parent\x64\Debug\Parent.exe
.  1	id: 2d4	child	name: notepad.exe</code></pre>
<p>To kill the child process, enter the command <b>.kill</b>. The parent process continues to run.</p>
<pre class="syntax" xml:space="preserve"><code>1:001&gt; .kill
Terminated.  Exit thread and process events will occur.
1:001&gt; g</code></pre>
<p><b>Using the -o parameter</b></p>
<p>When you start WinDbg or CDB, you can use the <b>-o</b> parameter to tell the debugger that it should attach to child processes. For example, the following command starts WinDbg, which starts and attaches to Parent.exe. When Parent.exe creates a child process, WinDbg attaches to the child process.</p>
<p><b>windbg -g -G -o Parent.exe</b></p>
<p>For more information, see <a href="#Bookmark1905"><b>WinDbg Command-Line Options</b></a> and <a href="#Bookmark1903"><b>CDB Command-Line Options</b></a>.</p>
<div class="code"></div>
<h2>Requirements</h2>
<table>
<tr>
<th width="30%">
<p>Version</p>
</th>
<td width="70%">
<p>Versions:(Kernel mode) Supported in Windows Server 2003 and later.</p></td></tr></table></div></div>	
	<div id="winchm_template_footer">Copyright &copy; 2019. All rights 
reserved. (To change the copyright info, just edit it in template.)</div>
</div>

</body>
</html>
